---
title: SDK 설정
description: Customize API keys, tracing and logging behavior
---

import { Code } from '@astrojs/starlight/components';
import setDefaultOpenAIKeyExample from '../../../../../../examples/docs/config/setDefaultOpenAIKey.ts?raw';
import setDefaultOpenAIClientExample from '../../../../../../examples/docs/config/setDefaultOpenAIClient.ts?raw';
import setOpenAIAPIExample from '../../../../../../examples/docs/config/setOpenAIAPI.ts?raw';
import setTracingExportApiKeyExample from '../../../../../../examples/docs/config/setTracingExportApiKey.ts?raw';
import setTracingDisabledExample from '../../../../../../examples/docs/config/setTracingDisabled.ts?raw';
import getLoggerExample from '../../../../../../examples/docs/config/getLogger.ts?raw';

## API 키와 클라이언트

기본적으로 SDK는 처음 임포트될 때 `OPENAI_API_KEY` 환경 변수를 읽습니다. 해당 변수를 설정할 수 없는 경우 `setDefaultOpenAIKey()`를 직접 호출할 수 있습니다.

<Code
  lang="typescript"
  code={setDefaultOpenAIKeyExample}
  title="기본 OpenAI 키 설정"
/>

직접 생성한 `OpenAI` 클라이언트 인스턴스를 전달할 수도 있습니다. 전달하지 않으면 SDK가 기본 키를 사용해 자동으로 생성합니다.

<Code
  lang="typescript"
  code={setDefaultOpenAIClientExample}
  title="기본 OpenAI 클라이언트 설정"
/>

마지막으로 Responses API와 Chat Completions API 사이를 전환할 수 있습니다.

<Code lang="typescript" code={setOpenAIAPIExample} title="OpenAI API 설정" />

## 트레이싱

트레이싱은 기본적으로 활성화되어 있으며 위 섹션의 OpenAI 키를 사용합니다.

별도의 키는 `setTracingExportApiKey()`를 통해 설정할 수 있습니다.

<Code
  lang="typescript"
  code={setTracingExportApiKeyExample}
  title="트레이싱 내보내기 API 키 설정"
/>

트레이싱을 완전히 비활성화할 수도 있습니다.

<Code
  lang="typescript"
  code={setTracingDisabledExample}
  title="트레이싱 비활성화"
/>

트레이싱 기능에 대해 더 알아보려면 [트레이싱](/openai-agents-js/ko/guides/tracing) 가이드를 확인하세요.

## 디버그 로깅

SDK는 디버그 로깅을 위해 [`debug`](https://www.npmjs.com/package/debug) 패키지를 사용합니다. 자세한 로그를 보려면 `DEBUG` 환경 변수를 `openai-agents*`로 설정하세요.

```bash
export DEBUG=openai-agents*
```

`@openai/agents`의 `getLogger(namespace)`를 사용해 모듈 전용 네임스페이스 로거를 얻을 수 있습니다.

<Code lang="typescript" code={getLoggerExample} title="로거 가져오기" />

### 로그의 민감한 데이터

일부 로그에는 사용자 데이터가 포함될 수 있습니다. 다음 환경 변수를 설정하여 비활성화하세요.

LLM 입력과 출력을 로깅하지 않으려면:

```bash
export OPENAI_AGENTS_DONT_LOG_MODEL_DATA=1
```

도구 입력과 출력을 로깅하지 않으려면:

```bash
export OPENAI_AGENTS_DONT_LOG_TOOL_DATA=1
```
